perm filename WHO.BH[UP,DOC]1 blob
sn#102823 filedate 1974-05-17 generic text, type T, neo UTF8
The WHO command (abbreviated W) runs the WHO program, which displays
system status information at your terminal. If you are at a display
terminal, the information is automatically updated as long as the
program continues to run. If you are at a Teletype, the information
is only typed once. The WHO command does not require that you be
logged in.
The first part of the WHO display is a list of the jobs on the
system, with various information about each job. This list is
divided into two sections, for jobs belonging to users and for system
phantom jobs. (More precisely, the second section contains jobs
which are detached and have the JLOG bit off in the job status word,
i.e., are not logged in.) Jobs attached to pseudo-teletypes are
listed under the controlling job, with the line for the controlled
job indented. The listing for each job has several parts:
JOB job number
QUEUE queue name, as in the WHO line, with possibly an extra
character meaning one of several states (if more than one
applies, the one listed first below is displayed):
- the job is now actually running
⊗ the job is locked in core
→ the job is an upper segment, next to be swapped in
↑ the job is next in line to be swapped out
↓ the job is next in line to be swapped in
* the job is swapped out
↔ the job is next in line to be moved in core
PPN the job's logged-in PPN
(This will be 100100 for not-logged-in WHOs, etc.)
LINE the job's terminal line number, or DET for detached jobs
JOBNAM the job name
SIZE the job's core image size in K (1024-word blocks)
TIME the job's total run time since login
PL percentage of CPU time spent on this job recently
SL service level reservation for this programmer
SEG job number of this job's upper segment
SW10 number of ticks between startups of job's PDP-10
spacewar module
SW6 number of ticks between startups of job's PDP-6
spacewar module
After the job display comes a similar display for upper segments,
containing the job number, job name, core size, and number of jobs
using the segment.
The next part of the WHO display is a summary of overall system
statistics. This includes the time since the system was last
restarted (UPTIME); short and long term time spent running the null
job (NULTIMES); short and long term time spent running the null job
when another job wanted to be run but wasn't in core (WASTED); total
user core image sizes in core and swapped out (CORE); the largest
contiguous free block of core, the total available user core not used
by locked-in jobs, and the total available user core (USABLE); the
number of jobs in RUNQ and TQ and their combined core image size
(RUNNING JOBS); and the total service level reservation for logged-in
users (TOTAL SLEVEL).
The final section of the WHO display is a list of all I/O devices in
use by programs or assigned by jobs. For each such use of a device
(at most one per device except for DSK), a line is displayed
containing the logical name, if any; the physical name; the character
"#" if the device was assigned by the ASSIGN command; the job number
using the device; if a particular file is open, the file name,
extension, and directory ppn (for disk files), the number of records
in the file, the record currently being read or written, and the
read/write status. This last will be W if the file is open for
output, R for input, or RA for read/alter mode, followed by E if the
end of file has been read. Note: if the file has been closed, there
may be no mode flag, and a large number like 1101 in the
current-record position. Record numbers are displayed in octal.
On display terminals, only a part of this display can fit on the
screen at any time. Single-character commands can be typed to WHO
which provide "scrolling" of the display as well as other functions.
The following commands are understood:
↓ scroll down 1/2 screen size
↑ scroll up 1/2 screen size
∞ run forever (otherwise WHO exits after nothing has been
typed in for two minutes)
R only display jobs which have recently been Running
(not in NULQ, STOP, IOWQ, or INTW)
M only display My jobs (login or alias programmer name must
agree with user's login or alias programmer name)
N restore Normal display (all jobs)
E Exit, leaving information displayed on the screen and with
the page printer set up to avoid erasing it
1-9 repeat argument for ↓ or ↑
Any other character will make WHO restore the page printer to normal
and exit.